home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu362.dms / pu362.adf / StarView.Doc < prev    next >
Encoding:
Text File  |  1992-03-06  |  6.4 KB  |  165 lines
  1.  
  2. ------------------------------
  3. STARVIEW by Neil Parry (C)1993
  4. ------------------------------
  5.  
  6. IMPORTANT!
  7. ----------
  8.  
  9. You are free to distribute this program providing that all the files remain
  10. unchanged and accompany the program. StarView is a shareware program,
  11. so if you find it useful, please send £5 to the following address:
  12.  
  13. Neil Parry.
  14. 35 Preston Lane,
  15. Bilton,
  16. Hull.
  17. HU11 4DE.
  18.  
  19.  
  20. 1. Introduction
  21. ---------------
  22.  
  23. StarView is a mouse-operated program designed to show graphically the
  24. positions of the stars and planets from any point on the earth. Most stars 
  25. above magnitude 4.5 are shown (over 850 in total), more than 100 with their 
  26. proper names. The outlines and names of all 88 constellations are also 
  27. given. Other features include zooming in/out, finding a constellation, 
  28. adjusting the level of detail shown, saved preferences and the ability to 
  29. print a view of the sky. The program was written using HiSoft's Power BASIC.
  30.  
  31.  
  32. 2. Using the program
  33. --------------------
  34.  
  35. 2.1. Entering the time and place.
  36.  
  37. The 'Change Time and Place' window can be accessed by clicking on the 
  38. time/place information boxes at the top of the screen. It will also be 
  39. brought up automatically when the program is first run. Click in the text 
  40. boxes to type in the details as follows:
  41.  
  42.    Date - in the format DD.MM.YYYY, any date from 1950 to 2050 is valid.
  43.  
  44.    Time - local time in the format HH.MM (24-clock).
  45.  
  46.    (If you have an internal clock, click on the NOW box and the current
  47.     date and time will be entered automatically.)
  48.  
  49.    Zone Offset - The offset between your local time and Greenwich Mean
  50.                  Time, in hours. For instance, this would be 0 in Britain
  51.                  in winter, -1 for British Summer Time, +10 for Western
  52.                  Australia, etc.
  53.  
  54.    Latitude - of your location in degrees 0-90 followed by N or S.
  55.  
  56.    Longitude - of your location in degrees 0-180 followed by E or W.
  57.  
  58.    Both latitude and longitude can be entered with up to 2 decimal places.
  59.  
  60. When finished click on EXIT, the program will calculate the star positions 
  61. for the time and place you've entered. If any of the values were invalid the 
  62. screen will flash and the cursor will be positioned on the value in error to 
  63. allow you to correct it.
  64. If you've changed your mind click on CANCEL to return to the program.
  65. The SAVE button will save your current time & place to disk (make sure the 
  66. disk isn't write-protected). These values will then be loaded up whenever 
  67. the program is first run.
  68.  
  69.  
  70. 2.2. Horizon View and Zenith View.
  71.  
  72. StarView displays the night sky in two separate views. The horizon view 
  73. shows a portion of the sky from the horizon up to an altitude of 70 degrees. 
  74. The zenith view shows a circular view of the sky centred around the zenith 
  75. (the point in the sky directly above your head), you can view the whole sky 
  76. at once in this mode. To switch between these two views, click on the icon 
  77. at the bottom right of the screen (a circle or a square depending on which 
  78. mode you're currently in).
  79.  
  80.  
  81. 2.3. Scrolling and Zooming the sky view.
  82.  
  83. Horizon View:
  84. On the horizon view are scales to show the azimuth (the direction you're 
  85. facing) and the altitude (the angle up from the horizon). These scales also 
  86. act as scroll bars for the view. Click in one of the bars and drag up/down 
  87. or left/right to scroll the view. Note that the altitude bar won't scroll 
  88. when on maximum zoom-out as it is at the limit of 0-70 degrees.
  89. To zoom in or out, click on the zoom bar at the bottom left of the screen 
  90. and drag left/right.
  91.  
  92. Zenith View:
  93. The zenith view shows the points of the compass around the edge of the 
  94. circular view, to rotate this view click on one of the compass points (or 
  95. anywhere just outside the circle) and drag the pointer around to adjust the 
  96. view to the angle you want.
  97. Zooming is achieved using the zoom bar, as with the horizon view. The zoom 
  98. is always centred around the zenith, the number next to the zoom bar being 
  99. the radius of sky currently being shown.
  100.  
  101. In addition, (in either view mode) the NSEW buttons on the left of the 
  102. screen can be used to centre the view on a particular compass direction.
  103.  
  104.  
  105. 2.4. The SetUp Menu.
  106.  
  107. Clicking on the SETUP button will bring up a menu of options which allow you 
  108. to adjust the level of detail shown on the sky view. The options are as 
  109. follows:
  110.  
  111. Constellations Identified (MAIN/MOST/ALL):
  112. Selects the number of constellations outlined and labelled on the screen, 
  113. MAIN shows just the brightest or most obvious constellations, MOST shows all 
  114. except the faintest and ALL displays all of them.
  115.  
  116. Constellation Outlines (OFF/ON):
  117. Selects whether constellation outlines will be drawn or not.
  118.  
  119. Constellation Names (OFF/ABBR/FULL):
  120. Selects how the constellation names will be displayed. FULL shows the full 
  121. constellation name, ABBR shows a three letter abbreviation.
  122.  
  123. Star Names (OFF/SOME/ALL):
  124. Over 100 star names are stored by the program, ALL will display all of them, 
  125. SOME will just label the brightest.
  126.  
  127. Planets (ON/OFF):
  128. Selects whether the planets will be shown or not. Note that the brightness 
  129. of the planets is not given, just the position, and in fact the outer three 
  130. planets (Uranus,Neptune & Pluto) are not actually visible with the naked 
  131. eye.
  132.  
  133. Star Symbols (DOT/BIG):
  134. Selects how the stars are displayed on the sky view. DOT represents a star 
  135. as a single dot that can be a different brightness depending on the 
  136. magnitude of the star. BIG represents brighter stars as a larger dot, which 
  137. is useful when printing out the screen.
  138.  
  139.  
  140. 2.5. Finding a constellation.
  141.  
  142. Clicking on the FIND button will bring up a list of all 88 constellations. 
  143. Click on a constellation and if it is visible, the program will find it and 
  144. return to the horizon or zenith view depending on where in the sky the 
  145. constellation currently is. If the constellation isn't visible, NOT VISIBLE 
  146. will flash at the bottom of the screen.
  147. This option also displays the abbreviations and meanings of the 
  148. constellation names.
  149.  
  150.  
  151. 2.6. Printing the screen.
  152.  
  153. Clicking on the PRINT button will print the screen. Note that this is simply 
  154. a graphic screen-dump and will be printed according to the printer settings 
  155. in Preferences. I've found that printing a black-and-white, negative image 
  156. with a threshold value of 14 produces good results. It also helps having the 
  157. star symbols set to BIG (in the Setup Menu) in order to determine the 
  158. magnitudes of the stars on a black-and-white print.
  159.  
  160.  
  161. 2.7. Quitting the program.
  162.  
  163. Click on QUIT to return to the Workbench.
  164.  
  165.